macos: fix weird menubar rendering.

As app menu has been deprecated, the function of app menu should be
merged into the menubar, which behaves like the original API of NSApp.

This also brings back the default app menu, which looks like native
macOS apps.

For future refactoring, please note that the menubar must contain at
least one menu before being set to NSApp to avoid weird menubar
rendering.

Fixes #3967.

Merge branch 'move-text-history-tests' into 'master'

Move text history tests

See merge request GNOME/gtk!3597

Merge branch 'picture-nullable-setters' into 'master'

picture: Make setters actually take NULL

Closes #3974

See merge request GNOME/gtk!3598

Move text history tests

We can test internal apis in our testsuite now,
so move the text history tests there, to have them
run in ci.

picture: Make setters actually take NULL

gtk_picture_set_file was claiming to be nullable,
but choked on NULL.

Fixes: #3974

Merge branch 'bilelmoussaoui/for-gi-docgen-link' into 'master'

gtk: drop unwanted char on Switch::state-set docs link

See merge request GNOME/gtk!3594

gtk: drop unwanted char on Switch::state-set docs link

Merge branch 'wip/exalm/checks' into 'master'

checkbutton: Sync the indicator state with the widget

See merge request GNOME/gtk!3568

Merge branch 'fix.vs2013.link' into 'master'

gtk/meson.build: Fix linking on Visual Studio 2013

See merge request GNOME/gtk!3575

Merge branch 'ebassi/introspection-error' into 'master'

Turn introspection scanner warnings into errors

See merge request GNOME/gtk!3588

Turn introspection scanner warnings into errors

We want to catch errors in our annotations or our API.

docs: Add missing documentation on Windows

The gtk_print_run_page_setup_dialog() function, and its asynchronous
variant, are declared in the common gtkprintoperation.h header, but
implemented in different source files depending on the platform.

Merge branch 'ignore-nosymbol-press' into 'master'

imcontext: Ignore NoSymbol key events

Closes #3973

See merge request GNOME/gtk!3591

imcontext: Ignore NoSymbol key events

These can happen with some XKB options.

Fixes: #3973

Merge branch 'bilelmoussaoui/for-gi-docgen' into 'master'

gdk: fix wrong doc annotation

See merge request GNOME/gtk!3590

gdk: fix wrong doc annotation

Update Ukrainian translation

Merge branch 'ebassi/docs-fixes' into 'master'

Enable fatal warnings for gi-docgen

See merge request GNOME/gtk!3587

Enable fatal warnings when build the docs

We want to fail the CI pipeline when the documentation generator emits a
warning.

docs: Fix the PANGO_SCALE link

The fragment for constants is `const`.

Merge branch 'fix-im-reset' into 'master'

imcontextsimple: Fix a possible problem

See merge request GNOME/gtk!3584

Merge branch 'matthiasc/for-master' into 'master'

doc: Syntax fixes

See merge request GNOME/gtk!3583

doc: Syntax fixes

No, we can't have links that say [constructor@...] or
[mehtod@...] or [methoc@...] or [methos@...] or [metohd@...].
And no, not [signals@...] either.

Merge branch 'bilelmoussaoui/gi-docgen-link-fix' into 'master'

gtk: fix gi-docgen link type

See merge request GNOME/gtk!3582

gtk: fix gi-docgen link type

constructors are supposed to use "ctor" as a link type, not new

Merge branch 'quartz-elide-underscores' into 'master'

Bring back elide_underscores

See merge request GNOME/gtk!3581

imcontextsimple: Fix a possible problem

We were forgetting to handle the compose sequence
case in reset().

quartz: Elide underscores again

We don't want a literal _File to show up in the
global menubar on OS X, so use the revivied
_gtk_elide_underscores.

Related: #3967

Bring back elide_underscores

This used to live in gtktoolbar.c, which is gone.
We still need it, so put it in gtkprivate.c.

Merge branch 'gallery-reflow-fix' into 'master'

docs: Convince the widget gallery to reflow

See merge request GNOME/gtk!3579

docs: Convince the widget gallery to reflow

Merge branch 'gst.gl.win32' into 'master'

media/gstreamer: Support using GL for video for Windows

See merge request GNOME/gtk!3506

media-gstreamer: Provide fallback mode for playback

Make the "gl-context" property of the GstGLSink readable as well so that
we can query whether the GstGLContext sharing really succeeded.  If it
did, then we proceed to playback our video using the glimagesink as we
did before.  If it didn't, throw out the GtkGstSink we were creating, and
re-create the GtkGstSink without the "gl-context" property, meaning that
we won't be using the glimagesink in this case.

gtkgstsink.c: Support EGL on Windows as well

Add support to look for and use the EGL context in Windows if it was activated
instead of desktop OpenGL.

GstGL may have been built with or without EGL/libANGLE support, so if it were,
check in GstGL whether we have gst_gl_display_new_with_type() to create a
GstGLDisplay that is of the GST_GL_WINDOW_WIN32 type when we are using
Desktop OpenGL (WGL), otherwise we show messages indicating that envvars
need to be set to initialize GstGL properly.

Due to a bug in GstGL, the GstGLContext can only be set up successfully
if one of the following is true:

*  An OpenGL 3.x or later emulator, such as Mesa is used (for WGL)
*  The latest GstGL master is being used, at the time of writing (for
   WGL)
*  GTK, libepoxy and GstGL are all built only with WGL support (for WGL)
*  EGL is being used in GTK at runtime

Special thanks to Matthew Waters for the help during the process.

media/gstreamer: Support using GL for video for Windows

Add support to share the WGL context in GDK with the WGL context in GStreamer,
so that we can also use OpenGL in the gstreamer media backend to playback
videos.  For now OpenGL/ES is not supported for this under Windows.

The process of setting this up in Windows is a little bit more involved, as:

*  The OpenGL support in GstGL requires a GL 4.1 Core context, but we may just
   get the GL version from wglCreateContextAttribsARB() that we pass into the
   attributes, which is 3.2 by default.  So, try to ask for a 4.1 Core context
   first if we are asking for anything less.

*  There is only one GstDisplay available for Windows, so we just use
   gst_gl_display_new().

*  We must explicitly tell libepoxy that we are using wglMakeCurrent() outside
   of libepoxy that is being used in GdkGL, otherwise we would end up crashing
   as the GL/WGL function pointers would become invalid.

*  We must also deactivate temporarily the underlying WGL context that was made
   current by gdk_gl_context_make_current() so that when
   gst_gl_display_create_context() calls wglShareLists(), we won't get bitten
   by error 0xaa (resource busy), as some drivers don't handle this well when
   the GL context is current in another thread.

For the last two points we make use of macros defined by the platforms that the
build is done for to help us carry out the necessary tasks as needed.

Thanks to Matthew Waters for the info on integrating GstGL and windowing
toolkits on Windows.

gtk/meson.build: Fix linking on Visual Studio 2013

Visual Studio 2013's linker does not suport `/WHOLEARCHIVE:`, so just
explicitly extract the objects from the static libraries that will
form the final GTK DLL.

Merge branch 'focusable-fixes' into 'master'

label: Fix mnemonic activation

Closes #3965

See merge request GNOME/gtk!3578

treeviewcolumn: Use focusable when we mean it

The focusable property has taken over the role that
can-focus had in GTK 3.

treeexpander: Use focusable where we mean it

This does not fix keyboard activation for tree expanders,
but it is more correct than using can-focus.

togglebutton: Fix mnemonic activation

We want to grab the focus when we're focusable, so
look at the focusable property.

floxbox: Fix focus navigation

We want to find focusable children, so we need to look at
the focusable property, not at can-focus. This is a change
from GTK 3, where can-focus was the correct property to
look at.

label: Fix mnemonic activation

The intention of the code is to find a focusable ancestor,
so it needs to look at the focusable property, not at
can-focus. This is a change from GTK 3, where can-focus
was the correct property to look at.

Fixes: #3965

Merge branch 'matthiasc/for-master' into 'master'

demos: Clean up doc comments

See merge request GNOME/gtk!3574

docs: More syntax fixes

The syntax for interface links is [iface@...], not
[interface@...].

docs: More syntax fixes

[`func@Foo`] is not the right link syntax either.

docs: Fix up syntax

There's no [type_func@...[ syntax, it is all [func@...].

docs: Sync up debug flag information

treemodel: Cosmetic docs changes

sortlistmodel: Cosmetic docs changes

expression: Cosmetic docs changes

textbuffer: Cosmetic docs changes

textview: Cosmetic docs changes

text: Cosmetic docs fixes

widget: Cosmetic docs changes

shortcutscontroller: Cosmetic docs changes

gdk: Cosmetic docs changes

directorylist: Cosmetic docs changes

eventcontroller: Cosmetic docs changes

sorter: Cosmetic docs changes

filter: Cosmetic docs changes

docs: Refer to backend APIs

Add links to the backend api docs.

docs: Fix a typo

docs: Avoid stairstepping

If you don't put empty lines between the items in a
definition list, markdown helpfully stairsteps them.
We don't want that!

docs: Update GSK_RENDERER docs

This did not mention the opengl and ngl values yet.

gtk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

gsk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

gdk: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

docs: Clean up docs syntax

Replace leftover gtk-doc syntax (#Type) with backquotes.

demos: Clean up doc comments

These don't show up anywhere, but might still clean
them up.

Update POTFILES.in

Merge branch 'wip/exalm/check-activate' into 'master'

checkbutton: Don't allow to uncheck radios by activating them

See merge request GNOME/gtk!3569

Merge branch 'doc-tweaks' into 'master'

Fix documentation syntax

See merge request GNOME/gtk!3572

docs: Reduce redundancy

Remove a boatload of "or %NULL" from nullable parameters
and return values. gi-docgen generates suitable text from
the annotation that we don't need to duplicate.

This adds a few missing nullable annotations too.

introspection: Stop using allow-none

allow-none has been deprecated for a long time
already. Instead use optional and nullable everywhere.

Documentation fixes

Mostly fixing up indentation of continuation lines,
and other small cleanups.

Fix documentation syntax

Properties use : in their link syntax.

Merge branch 'wip/exalm/switch-icons-2' into 'master'

icons: Fix switch-off icon

See merge request GNOME/gtk!3571

icons: Fix switch-off icon

It wasn't converted to paths and so wasn't rendered correctly.

Merge branch 'popover-docs' into 'master'

popover: Update docs

Closes #3960

See merge request GNOME/gtk!3570

popover: Update docs

Remove mention of show/hide animations, and mention
cascading close instead.

Fixes: #3960

checkbutton: Don't allow to uncheck radios by activating them

Do the same check as when clicking.

Update Ukrainian translation

Update Ukrainian translation

checkbutton: Sync the indicator state with the widget

Clicking the whole check button toggles it, so make sure the hover and
active states are propagated to the indicator like in GTK3.

Merge branch 'bilelmoussaoui/gdk-return-error-annotation' into 'master'

gdk: annotate Content Serialize/Deserialize return_error

See merge request GNOME/gtk!3567

gdk: annotate Content Serialize/Deserialize return_error

Merge branch 'fix-gst-media-file' into 'master'

gtkgstmediafile: Remove media-info-updated callback

Closes #3913

See merge request GNOME/gtk!3565

gtkgstmediafile: Remove media-info-updated callback

Instead, rely on position-updated which is also called always, and also
a little later than media-info-updated, giving GstPlayer time to figure
out more of the video info. Tested on local and remote mount videos,
images, sound files.

Works around / fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/3913,
https://gitlab.gnome.org/GNOME/gtk/-/issues/3914.

Merge branch 'matthiasc/for-master' into 'master'

Actually pass the devel profile to flatpak builds

See merge request GNOME/gtk!3563

Actually pass the devel profile to flatpak builds

I added that to the manifests, and did not notice that
we do the last build step manually :(

Merge branch 'wip/carlosg/sequence-accepted-in-group' into 'master'

gtkgesture: Apply gesture group state after setting up sequence

Closes #3946

See merge request GNOME/gtk!3560

Merge branch 'fix-gen-demo-conf' into 'master'

Fix generating demo_conf.h on builds without GIT in PATH

See merge request GNOME/gtk!3562

gen-demo-header.py: Fix running without git

The script assumes that the git program is in the PATH which may not be always
the case, so if git was not found, fallback to the former behavior of making
VCS_TAG an empty string if the profile option was not set to 'devel'.

Also fix the call to the script so that we do indeed call GIT on the source GIT
repo so that we can get the right short SHA1 sum.

Re-organize the code a bit in the process, so that things seem cleaner.

Merge branch 'wip/carlosg/reset-after-grab' into 'master'

Fixes to GTK grab notification

Closes #3942

See merge request GNOME/gtk!3561

gtkwindow: Fix "shadowed" checks for GTK grabs

We iterate here from the target widget up the toplevel checking
for the previous and new grab, there's however 2 bugs here:
- The check for is_shadowed was different to the check for was_shadowed
- The loop started with the assumption that the widgets did not hold
  a grab, just to change it if the grab widget was found. (or maybe
  it's the other way around? it's unclear with the differing checks
  for past/present state).

Make these checks consistent, and ensure we start with the right
assumption for the past/present grabbing state, and accounting that
new/old grab widgets may or may not be part of the pick stack.

gtkwindow: Rename function

With gtk_grab_notify_foreach() just taking care of emitting crossing
notifications due to the GTK grab change, rename it to a more apt
gtk_synthesize_grab_crossing().

gtkwindow: Simplify GTK grab notification

The _gtk_widget_grab_notify() function just (maybe) did a) reset
controllers and b) hide toplevels. The second part was a testing
remnant introduced in commit 024d832d943, not part of the original
fix.

Do the former more concisely, called from the place where we figure
out whether a widget's ability to receive events changed due to
GTK grabs. It's across those changes that we are interested in
resetting the controllers.

With the gestures being reset both ways, GtkWindowHandle (and
probably other) gestures are now able to reset after a GTK grab
takes input away (e.g. GtkMenuButton). This could be seen as
a sudden jump the next time they'd be dragged with the mouse,
as the gesture would "resume" the previous interaction.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3942

gtkgesture: Apply gesture group state after setting up sequence

When a new sequence is added to a GtkGesture, its state is looked
in other gestures in the same group, and made to match in this
gesture. This however happened a bit too early, before the
gesture touchpoint was fully set up. As this may result in signal
emission and whatnot, it's a good idea to make it happen with a
fully set up touchpoint.

Fixes: https://gitlab.gnome.org/GNOME/gtk/-/issues/3946

Merge branch 'ebassi/rev-parse-fallback' into 'master'

build: Check CI envvars before rev-parse

See merge request GNOME/gtk!3559

build: Check CI envvars before rev-parse

The CI pipeline does not do a full clone, so we cannot use `git
rev-parse` to get the short SHA checksum for the current commit.

Of course, since nothing's ever easy, we cannot use vcs_tag() with a
custom command, so we need to generate our out `demo_conf.h` header
straight from a script.